MPCreateQueue

MPCreateQueue
Header:	Multiprocessing.h		Carbon status:	Supported

Creates a message queue.

OSStatus MPCreateQueue (
    MPQueueID *queue
);

Parameter descriptions

queue: On return, the variable contains the ID of the newly created message queue.

function result: A result code. If a queue could not be created, MPCreateQueue returns kMPInsufficientResourcesErr.

DISCUSSION

This call creates a message queue, which can be used to notify (that is, send) and wait for (that is, receive) messages consisting of three 32-bit words in a preemptively safe manner.

Message queues are created from dynamically allocated internal resources. Other tasks may be competing for these resources so it is possible this function may not be able to create a queue.

See also the functions MPDeleteQueue and MPSetQueueReserve.

VERSION NOTES

Introduced with Multiprocessing Services 1.0.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.